离线安装引导集群

配置要求

表1 最小化部署硬件配置

节点类型	节点数量	vCPU（个）	内存（GB）	硬盘
引导节点	1	2	4	系统盘>=100G
业务集群节点	1	8	16	系统盘>=100G

表2 推荐硬件配置

节点类型	节点数量	vCPU（个）	内存（GB）	硬盘
引导节点	1	2	4	系统盘>=100G
业务集群	根据实际情况定	根据实际情况定	根据实际情况定	根据实际情况定

环境准备

• 准备一台裸机（裸机要求在公网环境下，用于在线场景中构建离线安装包）。

  说明：
  裸机配置可参考上述配置要求章节的引导节点相关配置信息。

• 确保这台机器没有/bke目录 。

• 安装tar、pigz、bkeadm和docker（docker版本暂无要求）。

  • tar工具安装版本可参考https://ftp.gnu.org/gnu/tar/。

  • pigz工具安装版本可参考https://zlib.net/pigz/。

  • bkeadm下载可执行如下命令进行安装。

    curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.06/download.sh | bash

安装步骤

1. 构建部署包。

   1.1 完成docker安装后，在docker配置文件中增加以下配置。

   编辑/etc/docker/daemon.json文件（如果没有就创建一个）。

    {
    "insecure-registries": [     
      "0.0.0.0/0"
    ]    
    }

   1.2 执行如下命令，重启docker。

    systemctl restart docker

   1.3 构建离线安装部署包。

   收集二进制文件、rpm包、Chart包等最后生成一个压缩包，offline-artifacts.yaml可单击下载。

   确定需要安装的扩展组件，将yaml文件中对应的镜像下载注释打开（默认为不打开）。如下是一个需要安装volcano组件，不安装ray组件的示例，该示例会下载volcano所需的镜像，不会下载ray依赖的镜像。

   扩展组件安装所需的三方镜像，如docker.io中的镜像目前没有制备在离线制品包中。

   - architecture:  # openfuyao 扩展组件
       - amd64
       - arm64
     sourceRepo: harbor.openfuyao.com/openfuyao
     targetRepo: kubernetes
     images:
       - name: volcano-config-website   #volcano
         tag:
           - v25.06
       - name: volcano-config-service   #volcano
         tag:
           - v25.06
       - name: numa-tuning-operator   #volcano
       tag:
           - v25.06
       - name: volcano/resource-exporter   #volcano
         tag:
           - v25.06
     #      - name: ray-website  #ray
     #        tag:
     #          - v25.06
     #      - name: ray-service   #ray
     #        tag:
     #          - v25.06     

   执行如下命令，构建离线安装部署包。

   说明： 持续时长大约1小时。 导包过程中出现报错会有重试机制，非导致过程终止的报错可忽略。

   rm -rf /bke && bke build -f offline-artifacts.yaml -t bke.tar.gz 

2. 进行离线安装。

   2.1 将部署包从在线环境中复制到离线环境引导节点（根据实际情况操作）。

   2.2 执行如下命令，解压部署包到根目录。

     rm -rf /bke && tar zxvf <部署包名字 eg: bke.tar.gz> -C /

   说明：
   建议解压后根目录存储空间大于29GB，否则影响初始化。

3. 修改BKE安装工具名称，并初始化引导节点。

   # 修改安装工具名称
   ARCH=$(uname -m)
   case $ARCH in
   x86_64) ARCH="amd64";;
   aarch64) ARCH="arm64";;
   esac
   mv /usr/bin/bkeadm_linux_$ARCH /usr/bin/bke
   # 初始化引导节点
   bke init 

4. 执行如下命令，可以查看引导集群上部署的Pod。

   kubectl get pod -A

   等待所有Pod状态正常后，则引导集群安装完毕，可以继续登录openFuyao管理面进行业务集群的安装。

卸载

1. 执行如下命令，重置引导集群。

   bke reset --all --mount

2. 执行如下命令，完全卸载BKE相关内容。

   rm -rf /bke
   rm -f /usr/bin/bke